home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Utilities / System / System Utilities / Shells / MacCLI / Instructions < prev    next >
Encoding:
Text File  |  1993-10-01  |  6.5 KB  |  145 lines  |  [TEXT/EDIT]
  1. ************************************************
  2. *
  3. * Instructions for MacCLI !!  (1/10/93)
  4. *
  5. ************************************************
  6.  
  7. This program is still in the developmental stages but at the
  8. present stage (1/10/93) it seems to be bug-free (with a few
  9. exceptions). And there is still a whole lot more to be added!!
  10.  
  11. /*-------------------------------------------------------------*/
  12.   Here is a list of the availible commands at this moment.
  13. /*-------------------------------------------------------------*/
  14.  
  15. • pwd    : prints current directory (this is printed always in the
  16.            window's status bar so its a bit redundant.
  17. • df     : prints a list of mounted volumes, the number of files on
  18.            that volume and also the free space.
  19. • new    : brings up a brand new console window!
  20. • history : prints out the history list with a * in front of the
  21.             current history position. you can scroll up and down the
  22.             history with the up and down arrows!!
  23. • history clear : clears out the history buffer.
  24. • ps     : prints out a list of the currently open windows and extra
  25.            stuff about em.
  26. • edit [filename] : without the argument this command brings up an
  27.            Untitled edit window (A text editor!!) and with the filename
  28.            it opens that file. (text file) there is no type (ie TEXT)
  29.            checking so you can open the data fork of any file (I think)!!
  30. • ls [directory] : The most Important command!! With no argument it
  31.            lists the files in the current directory or the directory
  32.            you specify.
  33. • cat <filename> : dumps the specified file onto the console window.
  34. • cd <directory> : Second most important command! Changes your current
  35.            directory
  36. • mkdir <directory> : makes a new directory.
  37. • rm-r <directory>  : recursively removes files in the specified directory.
  38.            BE VERY CAREFUL WITH THIS COMMAND!! DONT GO AND REMOVE YOUR
  39.            ENTIRE DISK! (by accident that is :)
  40. • rm <filename/directory> : removes a file or emtpy directory.
  41. • move <filename/directory> | <directory> : moves a file or directory into
  42.            a new one.
  43. • rename <filename> | <newfilename> : renames a file.
  44. ** cp command will be a binary .. not availible in sample MacCLI **
  45. • cp <filename> | <newfilename> : copies a file.
  46. • cp-v "                    "   : copies a file but verifies the writes.
  47. • cpdir <directory> | <newdirectory> : copies an entire directory (all
  48.             subdirectories and files too.
  49. • path <full pathname> : adds the pathname specified to the search path
  50.     list of that console. With no argument, path prints out the path
  51.     search list.
  52. • alias <aliasname> <command> : alias makes it easy to have a shortened
  53.     version of a command in aliasname. the <command> paramater takes the
  54.     wildcard character ¿ (opt-shift-?), ie 'alias l ls ¿' will make l
  55.     the equivalent command for ls, the ¿ makes the argument of l included.
  56.     alias without argument will print the current alias's
  57. • set <var> <string> : will make <string> the equivalent of <var> as
  58.     a shell variable, so in the command line using {<var>} will replace
  59.     <var> with <string>, set with no arguments prints out current
  60.     shell variables.
  61.  
  62. Search Paths:
  63. ------------
  64. The list of search paths make it possible for the binary commands
  65. (currently ls and cat) to work properly. The search paths are setup
  66. in the .console file. They also enable applications to be launched from
  67. some other directory if that apps path is included you only need type
  68. the applications name. However if you have changed to that app's dir
  69. then you can type the application name as it is. The same applies to
  70. script files. It is advisable to look through the .console and .startup
  71. files.
  72.  
  73. ••••••••
  74. The ls and cat commands are binaries.. (experimental system) and
  75. they run as separate processes (multitasking!)
  76. ********
  77.  
  78. The menus are pretty simple and self-explanitory :)
  79.  
  80. Who did what... ??
  81. ---------------------
  82. Astro: Console and edit windows with extensions to objects. Impementation of
  83.        history in the console. All file handling. Menus. About Box (as well
  84.        as drawing it!). New command interpreter (allowing full editing on
  85.        command line). Converting history pointers to relocatable objects.
  86.        Added Threads to the program *yay*. Astro has also just done rudimentry
  87.        scripting and aliasing.. hopes Thorfinn will make em more
  88.        sophisticated :)
  89. Thorfinn: Nifi C tricks with strings. Such as space and tab handling in
  90.        filenames. (Thorfinn's been pretty lazy so hes got to write the scripting
  91.        language and the aliases etc :) heh heh.
  92. Skelmir: A source of inspiration :) hehe + got Astro started on the history 
  93.        Skelmir has also written MacMud!!! and its really cool! (Astro is
  94.        persuading Skelmir to put MacCLI console into the local mode of
  95.        MacMud :)
  96.  
  97. Other STuff..
  98. --------------------
  99. MacCLI was and is written in Think C 5.0.2 + objects (but not the TCL
  100. library). MacCLI started off as an experminent using the Think C console
  101. but soon developed into an application once Astro & Thorfinn realised that
  102. the Think C console was a bit limited for what was needed to be done.
  103. Since Astro wrote the File Handling routines he got Thorfinn to go off
  104. and write the Console window. However as mentioned above Thorfinn decided
  105. to be lazy. So Astro went and wrote it (as well as the rest of the new 
  106. stuff). Skelmir came along and gave astro a hint on doing the history :)
  107.  
  108. Legal Crap..
  109. --------------------
  110. MacCLI is FREEWARE!! (if you actually want it that is) really we should be
  111. paying you to have it!. Anyway what this means is that you get shitted on
  112. if you try and make money out of it. Thats all I want to say about that.
  113.  
  114. Extra Credits..
  115. --------------------
  116. Many Thanks to Roy Wood of Silcon Angst software for writing TE32K.
  117. As you may have noticed its used in the editor window :) so you can
  118. open extra big files. 
  119.  
  120. Bugs......... :(
  121. --------------------
  122. MacCLI doesnt do any memory checking when you open windows (yet) etc or the like
  123. so if you are not careful you will CRASH the program Yay :)
  124.  
  125.  
  126. Where to find everyone!
  127. -----------------------
  128. Astro: email: 2119735@hydra.maths.unsw.edu.au
  129.               
  130.        snailmail: 39 The Crescent 
  131.                   Vaucluse 2030
  132.                   NSW
  133.                   Australia.
  134. Thorfinn: email: s2105420@spectrum.cs.unsw.oz.au
  135.        snailmail: ?? erm. :) *shrug*
  136. Skelmir: email: skelmir@uvapsy.psy.uva.nl
  137.                 
  138.          snailmail: *shrug* :) somewhere in Amsterdam :)
  139.  
  140. ---------------
  141.  
  142. This has been an announcement from Chaos Inc.
  143.  
  144. ---------------
  145.